↓메인 콘텐츠로 이동하기
  1. Hugo & Congo 문서/

Front Matter

3 분
각 글마다 상단에 있는 메타데이터를 프론트 매터라고 합니다.

편집자 주: Congo는 개별 문서의 표현을 사용자 지정하기 위해 여러 프론트 매터 매개변수를 추가합니다.
프론트 매터 매개변수는 마땅히 번역할 말이 떠오르지 않더라고요. 그냥 프론트 매터, 혹은 front matter 매개변수라고 부르겠습니다. 예를 들어, 보고 계신 이 글에는 이런 프론트 매터를 지정했습니다.

---
title: "Front Matter"
date: 2020-08-12
draft: false
---

프론트 매터 매개변수의 기본값은 테마의 기본 설정에서 상속되므로, 기본값을 재정의하고 싶은 경우에만 프론트 매터에 지정합니다.

Name Default Description
title Not set 문서의 제목입니다.
description Not set 문서의 설명입니다. HTML 메타데이터에 사용됩니다.
feature "*feature*" 문서의 특징 이미지 파일명 패턴입니다.
featureAlt "" 문서의 특징 이미지 대체 텍스트 설명입니다.
cover "*cover*" 문서의 커버 이미지 파일명 패턴입니다.
coverAlt featureAlt 문서의 커버 이미지 대체 텍스트 설명입니다.
coverCaption Not set 문서의 커버 이미지 아래에 표시될 캡션 텍스트입니다.
thumbnail "*thumb*"_ 문서의 썸네일 이미지 파일명 패턴입니다.
thumbnailAlt featureAlt 문서의 썸네일 이미지 대체 텍스트 설명입니다.
externalUrl Not set 만약 이 문서가 외부 웹사이트에 게시되어 있다면, 이 문서의 URL입니다. URL을 제공하면 콘텐츠 페이지가 생성되지 않고, 이 문서에 대한 참조는 외부 웹사이트로 직접 연결됩니다.
editURL article.editURL 만약 showEdit이 활성화되어 있다면, 편집 링크의 URL입니다.
editAppendPath article.editAppendPath 만약 showEdit이 활성화되어 있다면, 현재 문서의 경로를 editURL에 설정된 URL에 추가할지 여부입니다.
groupByYear list.groupByYear 목록 페이지에서 문서가 연도별로 그룹화되어야 하는지 여부입니다.
keywords Not set 문서 메타데이터에 포함되어야 하는 키워드입니다.
menu Not set 값이 제공되면, 이 문서에 대한 링크가 지정된 메뉴에 나타납니다. 유효한 값은 main 또는 footer입니다.
robots Not set 로봇이 이 문서를 처리해야 하는 방법을 나타내는 문자열입니다. 값이 설정되면, 페이지 헤드에 출력됩니다. 유효한 값은 Google의 문서를 참조하세요.
sharingLinks article.sharingLinks 이 문서 마지막에 표시할 공유 링크입니다. 제공되지 않거나 false로 설정되면 링크가 표시되지 않습니다.
showAuthor article.showAuthor 문서 푸터에 저자 상자가 표시되어야 하는지 여부입니다.
showBreadcrumbs article.showBreadcrumbs or list.showBreadcrumbs 문서 또는 목록 헤더에 브레드크럼스가 표시되어야 하는지 여부입니다.
showDate article.showDate 문서 날짜가 표시되어야 하는지 여부입니다. 날짜는 date 매개변수를 사용하여 설정됩니다.
showDateUpdated article.showDateUpdated 문서가 업데이트된 날짜가 표시되어야 하는지 여부입니다. 날짜는 lastmod 매개변수를 사용하여 설정됩니다.
showEdit article.showEdit 문서 콘텐츠를 편집할 수 있는 링크가 표시되어야 하는지 여부입니다.
showHeadingAnchors article.showHeadingAnchors 문서 내 제목 옆에 앵커 링크가 표시되어야 하는지 여부입니다.
showPagination article.showPagination 문서 푸터에 다음/이전 문서 링크가 표시되어야 하는지 여부입니다.
invertPagination article.invertPagination 다음/이전 문서 링크의 방향을 뒤집어야 하는지 여부입니다.
showReadingTime article.showReadingTime 문서 읽는 시간이 표시되어야 하는지 여부입니다.
showTaxonomies article.showTaxonomies 이 문서와 관련된 태그가 표시되어야 하는지 여부입니다.
showTableOfContents article.showTableOfContents 문서에 목차가 표시되어야 하는지 여부입니다.
showWordCount article.showWordCount 문서 단어 수가 표시되어야 하는지 여부입니다.
showComments article.showComments 문서 푸터 뒤에 댓글 파트가 포함되어야 하는지 여부입니다.
showSummary list.showSummary 목록 페이지에서 문서 요약이 표시되어야 하는지 여부입니다.
summary summaryLength 값을 사용하여 자동으로 생성됩니다. (https://blog.beheppen.com/hugo-docs/configuration/#site-configuration) 참고 showSummary이 활성화되어 있다면, 이 문서에 대한 요약입니다.
xml sitemap.excludedKinds 에서 제외되지 않는다면 true 생성된 /sitemap.xml 파일에 이 문서가 포함되어야 하는지 여부입니다.